home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / fortran / toolpack.000 / toolpack / toolpack1.2 / README.X < prev    next >
Encoding:
Text File  |  1989-03-04  |  12.7 KB  |  347 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  NAG Unix 4.2bsd TOOLPACK/1 TAPE
  7.  
  8.                           Release: 2.1
  9.  
  10.                    README NOTES FOR INSTALLERS
  11.  
  12.  
  13.  
  14.  
  15. 1.  Tape Format Information
  16.  
  17.    The format of the tape is given on the printed tape label. The
  18.    following information applies to all formats;
  19.  
  20.    The  information is recorded: 9 track, phase encoded, 1600bpi.
  21.    The  files  on  the  tape  contain  upper   and   lower   case
  22.    characters.
  23.  
  24.    The data is stored in 'tar' format for Unix(tm) sites.
  25.    The  files are restored into a sub-tree rooted at 'toolpack1.2'
  26.    in the current working directory.
  27.  
  28.  
  29. 2.  Disclaimer
  30.  
  31.    Toolpack/1  Release  2.1 is the second Release of the Toolpack
  32.    Fortran software tools distribution tape. It replaces  Release
  33.    1.1  which  was first Released in February 1985.  The software
  34.    is  the  result  of  an  international  collaborative  project
  35.    started  in  1979. The project was supported by the Department
  36.    of Energy and the National Science Foundation in the  USA  and
  37.    by  the  Science  and  Engineering Research Council in the UK.
  38.    Additional material for Release 2.1 has  been  provided  by  a
  39.    number  of organisations as a result of work carried out since
  40.    Release 1.1.
  41.  
  42.    In  making  Toolpack/1  available,  NAG   is   acting   as   a
  43.    distribution agent on behalf of the Toolpack Council.  Neither
  44.    NAG  nor  the  other Toolpack participants nor contributors of
  45.    host specific TIECODE installations accept responsibility  for
  46.    the  content  or  performance of Toolpack/1, and  none of them
  47.    will be liable in any way for the use  of  Toolpack/1  or  the
  48.    consequences of such use.
  49.  
  50.  
  51.  
  52. 3.  Tape Content Information
  53.  
  54.    This   tape   contains    Toolpack/1    Release  2   software;
  55.    TIEC,   tools, and an easy to install Makefile.
  56.  
  57.  
  58.  
  59. 4.  Documentation
  60.  
  61.     This tape  contains no  documentation. We  reccomend that you
  62.     purchase  either a printed  set of documentation, or a Type A
  63.     tape for a machine readable set of documents.
  64.  
  65.  
  66.  
  67. 5.  What To Do Next
  68.  
  69.    Before proceeding to  install  Toolpack/1,  you  are  STRONGLY
  70.    advised  to  read  this document.
  71.  
  72.    Upgrading from Release:1
  73.  
  74.    Sites that have already  installed  Release  1  of  Toolpack/1
  75.    should note the following;
  76.  
  77.       All tools should be replaced with the new versions.
  78.  
  79.  
  80. 6.  Service and Support
  81.  
  82.    While   continuing  to  provide  a  distribution  service  for
  83.    Toolpack/1, NAG can no longer undertake to provide a free  bug
  84.    fixing service.  NAG will continue to receive bug reports, but
  85.    no  guarantee  of response can be given except for those sites
  86.    subscribing to the enhanced level of support (Service D).
  87.  
  88.  
  89.  
  90. 7.  Feedback
  91.  
  92.    This public distribution of Toolpack/1 is meant to  provide  a
  93.    useful  tool  suite  for  processing Fortran 77 and to promote
  94.    further interest in the  development  of  programming  support
  95.    environments.  You  and  your  Toolpack/1 users may be able to
  96.    assist that development in several ways:
  97.  
  98.  
  99.    Tools: As  well  as  providing  tools   for   immediate   use,
  100.        Toolpack/1 provides the capabilities required for users to
  101.        produce  portable  tools for the Fortran community. If you
  102.        build any  tools  that  could  be  converted  to  the  TIE
  103.        portability  base  (and,  if  appropriate,  the Toolpack/1
  104.        token stream and/or parse trees) please  inform  the  tape
  105.        distributor.
  106.  
  107.    General: Reports  of  suspected  errors, comments, suggestions
  108.        and criticisms would all be appreciated.
  109.  
  110.    All communications on the above catagories may be addressed in
  111.    writing to the following address. An example  form  that  will
  112.    ensure  that all the relevant information is provided is shown
  113.    in Appendix B.
  114.  
  115.        Toolpack/1  Distribution Service
  116.        Numerical Algorithms Group Ltd
  117.        Mayfield House
  118.        256 Banbury Road
  119.        Oxford
  120.        United Kingdom   OX2 7DE
  121.  
  122.    North American sites should contact NAG  Incorporated  at  the
  123.    Address below:
  124.  
  125.        Toolpack/1  Distribution Service
  126.        Numerical Algorithms Group Inc
  127.        1101 31st Street, Suite 100
  128.        Downers Grove, IL 60515-1263
  129.        USA
  130.  
  131.  
  132.    Target Language
  133.  
  134.    There  have  been  some extensions made to the target language
  135.    processed by Toolpack/1 tools. The extensions are described in
  136.    the Toolpack/1 Fortran Definition documentation.
  137.  
  138.  
  139.    Software
  140.  
  141.    The software has had all available bug fixes  reported  during
  142.    the life of Release 1 applied.
  143.  
  144.  
  145.    The following implementation of TIE has been provided:
  146.  
  147.    TIEC The TIEC implementation for Unix 4.2bsd is included, this
  148.          version  is written in C and is intended for use on Unix
  149.          based systems.
  150.  
  151.  
  152.    Supplementary Libraries
  153.  
  154.    ACCESS The access functions for ISTPR format trees  have  been
  155.          removed.  There are additional functions to allow access
  156.          to the attribute information generated by  ISTSA.  There
  157.          have  been extensive changes made to both the formats of
  158.          intermediate files and the  operation  of  token  stream
  159.          access functions. These changes have 2 benefits. Firstly
  160.          they  make  operation  much  faster  as fewer read/write
  161.          operations are required. Secondly it is now possible  to
  162.          use  the  scanner and polish tools as subroutines within
  163.          user written tools,  avoiding  the  need  to  write  out
  164.          intermediate  files when these are not actually required
  165.          for further processing. Additional token and parse  tree
  166.          node types have been added. There is no longer any BLOCK
  167.          DATA  in  this library, ZCTYPE/ZBTYPE have been replaced
  168.          with an include file of parameters (ZPTYPE).
  169.    STRING A new routine has been added to check the  legality  of
  170.          Fortran variable, routine and common block names.  There
  171.          is now no BLOCK DATA associated with this library.
  172.    TABLES A  new  set of linked list functions have been provided
  173.          that allow the setting up and manipulation of  lists  of
  174.          linked lists.
  175.  
  176.  
  177.    Tools
  178.  
  179.    Below  is  a  list  of the tools giving a brief description of
  180.    their function and changes that  have  been  introduced  since
  181.    Release  1.1,  these  changes are in addition to the fixing of
  182.    bugs and  tidying  of  code  to  improve  maintainability  and
  183.    readability.
  184.  
  185.     ISTAL The  documentation  generation  aid.  This tool can now
  186.           report unexecuted segments in instrumented  code.  Some
  187.           other minor improvements have also been made.
  188.     ISTAN The Fortran 77 instrumentor has been improved.
  189.     ISTCD/ISTSB/ISTUD These  three  new  tools  will  unroll  and
  190.           condense  DO  loops. The restructured code is in a form
  191.           that can be more  easily  optimised  by  compilers  for
  192.           vector machines.
  193.     ISTCN A  simple, stream based token stream editor that can be
  194.           used for changing strings within Fortran program units.
  195.           A new tool at this Release.
  196.     ISTCR A name changer for Fortran  program  units  that  works
  197.           selectively  on  the  symbol  table. A new tool at this
  198.           Release.
  199.     ISTDC The data file comparison tool has been  tidied  up  but
  200.           remains operationally unchanged.
  201.     ISTDS The  declaration  standardiser,  this can now deal with
  202.           the new types and also will  not  interfer  with  items
  203.           declared  in  INCLUDE files if these have been included
  204.           using ISTIN.
  205.     ISTFD The fortran differencer has remain unchanged.
  206.     ISTFP The fast polish utility.
  207.     ISTFR A  new  tool to convert REAL, DOUBLE PRECISION, COMPLEX
  208.           and DOUBLE COMPLEX constants to a consistent form.
  209.     ISTGI The tool to turn intrinsics into generic references has
  210.           remained essentially  unchanged  but  now  accepts  the
  211.           defined DOUBLE COMPLEX intrinsics.
  212.     ISTJS A  new  tool  to manipulate FORMAT statements, can join
  213.           adjacent strings and turn H and X edit descriptors into
  214.           strings.
  215.     ISTLS A long name changer,  allows  Fortran  programs  to  be
  216.           written  using  long  variable names, this tool then be
  217.           using to map them to legal names. This is a new tool at
  218.           this Release.
  219.     ISTLX The Fortran 77 scanner tool files. This tool  has  been
  220.           extensively  modified.  The tool can now split up files
  221.           into individual token streams, one per program unit, to
  222.           assist in the processing  of  large  input  files.  The
  223.           error  file has now been dropped and the list file made
  224.           optional. There are changes to the format of the  token
  225.           stream and comment file to speed operation. The grammar
  226.           has  been  modified to handle all types of comments, to
  227.           allow   DOUBLE   COMPLEX   and   to   improve   general
  228.           processing.
  229.     ISTME A  new  tool  to modify complicated expressions so that
  230.           during calculation the sub-expression stack is kept  to
  231.           a minimum.
  232.     ISTPF A  new  tool,  this provides a Fortran 77 equivalent of
  233.           the PFORT portablility verifier capability.
  234.     ISTPL The polish tool has been modified to cope with the  new
  235.           token  types,  several new processing options have also
  236.           been added.
  237.     ISTPO The polish option editor has been  modified  to  accept
  238.           the new polish options.
  239.     ISTPP Ensures  the consistency of PARAMETER statements across
  240.           program units.
  241.     ISTPT The arithmetic precision transformer can now handle the
  242.           defined COMPLEX/DOUBLE COMPLEX mappings.
  243.     ISTRF The  text  formatter  has  been  modified  to   provide
  244.           additional functionality.  The most important result of
  245.           this  is  that  Toolpack/1  documentation  can  now  be
  246.           processed by ISTRF in a single stage without  the  need
  247.           for pre-processing through ISTMP.
  248.     ISTSA A  new  tool  providing a static analysis capability to
  249.           check software conformance to the Fortran 77 standard.
  250.     ISTST A new tool that will rebuild the structure of  programs
  251.           to a standard form.
  252.     ISTUN This  tool  reverses  the  effect  of  ISTIN, replacing
  253.           included files by an INCLUDE statement.
  254.     ISTVA The attribute viewing utility is a  new  tool  at  this
  255.           Release  that  allows the user to examine the attribute
  256.           tables created by ISTSA.
  257.     ISTVC The  version  controller  file.  The  minus  sign   for
  258.           specifying options is now optional.
  259.     ISTVS The  symbol  viewing  utility  allows users to view the
  260.           symbol table.
  261.     ISTVW A  new tool, based on ISTVS that gives a simple listing
  262.           of warnings about a program unit. The warnings are  the
  263.           same as those reported by ISTAL.
  264.     ISTYF The parse tree flattener.
  265.     ISTYP The  parser  has  been  modified  to  accept the target
  266.           language extensions.  The output form of the parser has
  267.           been modified to speed up operation.
  268.  
  269.  
  270.     Combined Tool Fragments
  271.  
  272.     ISTDT The combined ISTYP/ISTDS/ISTPL tool.  Token  stream  to
  273.           source with declaration standardisation.
  274.     ISTLA The  combined  ISTLX/ISTYP/ISTSA  tool.  Source to full
  275.           static analysis.
  276.     ISTLP The  combined  ISTLX/ISTPL  tool.  Source   to   source
  277.           polishing operation.
  278.     ISTLY The combined ISTLX/ISTYP tool. Source to parse tree.
  279.     ISTP2 The  combined  ISTLX/ISTPP/ISTPL tool. Source to source
  280.           parameter setting.
  281.     ISTQD The combined ISTLX/ISTYP/ISTDS/ISTPL  tool.  Source  to
  282.           source declaration standardiser.
  283.     ISTQP The  combined  ISTLX/ISTYP/ISTPT/ISTPL  tool. Source to
  284.           source precision convertor.
  285.     ISTQT The combined ISTLX/ISTYP/ISTPT tool.  Source  to  token
  286.           stream with a precision conversion.
  287.  
  288.  
  289.     ****** Toolpack/1 Release 2 Problem Reporting Form ******
  290.  
  291. _______________________________________________________________________________
  292.  
  293.  1) Details of person raising report.
  294.  
  295.    Name:
  296.    Address:
  297.  
  298.  
  299.    Phone:                         Extension:
  300.  
  301.    Date:
  302. _______________________________________________________________________________
  303.  
  304.  2) Details of Toolpack installation.
  305.  
  306.   Host computer/operating  system:
  307.  
  308.   TIE Implementation in use:         TIECODE  System..............
  309.                                      TIEVMS   TIEC   Other:
  310.   Toolpack Update Notices applied:
  311.  
  312.   Does your site subscribe to the Toolpack/1 support service?   YES/NO
  313. _______________________________________________________________________________
  314.  
  315.  3) Report:
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. _______________________________________________________________________________
  339.  
  340.  4) Enclosures:
  341.  
  342. _______________________________________________________________________________
  343. ------------------------------FOR NAG USE ONLY---------------------------------
  344.  Reference:                 Support service:
  345.  Date received:             Routed to:                Date completed:
  346.  Action  taken:
  347.